home *** CD-ROM | disk | FTP | other *** search
/ Aminet 16 / Aminet 16 (1996)(GTI - Schatztruhe)[!][Dec 1996].iso / Aminet / dev / c / C_OS3_DT431.readme < prev    next >
Text File  |  1996-11-03  |  7KB  |  157 lines
  1. Short:    How: OS3 V40/43 PicDatatype in 100% C
  2. Author:   Andreas_Kleinert@t-online.de
  3. Type:     dev/c
  4. Replaces: dev/c/C_OS3-DT403.LHA
  5.  
  6.  
  7.   samplePNM.datatype and source-code V43.1 (25.10.96)
  8.   (C) 1996 by Andreas R. Kleinert. All rights reserved.
  9.  
  10.   ---
  11.   This small sample datatype source code demonstrates, how to completely
  12.   write an Amiga OS 3 datatype (V40/V43) without any assembler stubs
  13.   or compiler/linker tricks in PURE C source code (currently SAS/C-based).
  14.  
  15.   You may e.g. use this example source code to write more portable
  16.   Amiga OS 3 datatypes to allow easier porting of these
  17.   to other Amiga OS-derived operating systems, or the native
  18.   OS of an upcoming PowerPC Amiga.
  19.  
  20.   Translate your 68k-assembler datatype startup-codes smartly
  21.   to C by simply using this source-code as an advice how to do it.
  22.  
  23.  
  24.   As a common case, a datatype of class picture, supporting
  25.   PNM-PGM (P5) and PNM-PPM (P6) has been used as an example.
  26.  
  27.   With picture.datatype V40-42 only PGM is supported,
  28.   and with picture.datatype V43 reading of PPM is offered as well,
  29.   while encountering an PGM file under V43 causes a fallback to V40
  30.   routines (could have been done differently, but was not necessary
  31.   here just for demonstration).
  32.  
  33.   For testing this datatype, simply use a tool from the NetPBM package
  34.   (or maybe for example a tool supporting superview.library) and save
  35.   a graphics in the binary PGM or PPM format (P5/P6 of the PNM series).
  36.  
  37.   Then install this datatype and try loading the file via MultiView.
  38.   Should work fine.
  39.  
  40.   ---
  41.   Feel free to use this source for own projects.
  42.  
  43.   It is allowed to be spread and distributed anywhere, as far
  44.   as my consent is concerned.
  45.  
  46.   Amiga Technologies, or the current owner of the technologie,
  47.   is allowed to always put this source on their newest
  48.   Developer CD-ROM.
  49.  
  50.   Thanks and credits will always be appreciated - for example,
  51.   you MAY, but NEED NOT:
  52.   give me credits in your program's docs, send me keyfiles for
  53.   your programs using the library, and so on.
  54.   But that's simply voluntarily.
  55.  
  56.   This work was only roughly inspired by David Junod's original
  57.   example source codes for datatypes.
  58.  
  59.    _________________________________________________________
  60.   |      You may reach me the following way.                |
  61.   |    Send bug-reports, money or whatever to:              |
  62.   |---------------------------------------------------------|
  63.   |        * SuperView Development & Registration *         |
  64.   |          * DRAFU Development & Registration *           |
  65.   |       * Image Engineer Registration Site Europe *       |
  66.   |                                                         |
  67.   |                                                         |
  68.   |                  PerSuaSiVe SoftWorX                    |
  69.   |                                                         |
  70.   |                  Andreas R. Kleinert                    |
  71.   |                  Sandstrasse 1                          |
  72.   |                  D-57072 Siegen                         |
  73.   |                  Germany, Europe                        |
  74.   |                                                         |
  75.   | Any snail mail to the old address will still be routed. |
  76.   |                                                         |
  77.   |                  Phone:  +49-271-22869 also FAX + AM    |
  78.   |                          +49-271-22838                  |
  79.   |                                                         |
  80.   |                  Weekdays after 17.00h.                 |
  81.   |                                                         |
  82.   |         When calling via phone you may leave a message, |
  83.   |         if I'm not available - but don't expect me      |
  84.   |         calling back to USA, Australia, ... since       |
  85.   |         german phone rates are HIGHLY expensive.        |
  86.   |_________________________________________________________|
  87.  
  88.   EMail:
  89.  
  90.         DO not SEND ANY binaries (or uuencoded) VIA THE
  91.         FOLLOWING EMAIL ADDRESSES, EXCEPT MAYBE small ONES
  92.         VIA t-online.de (smaller or equal 16 KB).
  93.         THANK YOU.
  94.  
  95.            - Fido    Andreas Kleinert 2:2457/350.18
  96.            - Usenet
  97.                      Andreas_Kleinert@superview.ftn.sub.org  (Fido-Gate)
  98.                      Andreas_Kleinert@t-online.de            (T-Online)
  99.                      ARK@COB.wwbnet.de                       (Z-Netz)
  100.  
  101.            - If nothing else works, try one of these public
  102.              Fido-Usenet gateways:
  103.  
  104.                In Germany:
  105.                  Andreas_Kleinert@p18.f350.n2457.z2.fido.sub.org
  106.  
  107.                From USA or elsewhere:
  108.                  Andreas_Kleinert@p18.f350.n2457.z2.fidonet.org
  109.  
  110.         Please note, that the "superview.ftn.sub.org"
  111.         domain will perhaps be renamed in late 1996.
  112.  
  113.  
  114.  History:
  115.  
  116.  V43.1 (25.10.96) : - added picture datatype V43 support
  117.                     - thus added support for 24 Bit PPM (P6),
  118.                       since PGM only has 256 grayscales
  119.                     - thus renamed to samplePNM.datatype
  120.  
  121.  V40.3 (13.9.96)  : - fixed more "style" things
  122.  
  123.  V40.2 (5.9.96)   : - fixed some "style" things
  124.  
  125.  V40.1 (2.9.96)   : - first release
  126.  
  127.  ---
  128.  All mentioned trademarks are subjects to their owners.
  129.  
  130.  
  131. ============================= Archive contents =============================
  132.  
  133. Original  Packed Ratio    Date     Time    Name
  134. -------- ------- ----- --------- --------  -------------
  135.     4876    2517 48.3% 25-Oct-96 17:40:02 +samplePNM.datatype
  136.       86      76 11.6% 25-Oct-96 16:26:52 +PGM
  137.      467     279 40.2% 25-Oct-96 16:26:52 +PGM.info
  138.       86      76 11.6% 25-Oct-96 16:27:44 +PPM
  139.      467     279 40.2% 25-Oct-96 16:27:44 +PPM.info
  140.      107     102  4.6% 25-Oct-96 17:34:40 +CompileNote.readme
  141.      778     335 56.9% 02-Sep-96 16:43:42 +classbase.h
  142.    11004    2799 74.5% 25-Oct-96 17:39:44 +libfuncs.c
  143.      739     301 59.2% 25-Oct-96 16:17:50 +libfuncs.h
  144.     3652    1988 45.5% 25-Oct-96 17:39:58 +libfuncs.o
  145.     3943    1226 68.9% 25-Oct-96 16:23:58 +LibInit.c
  146.     1464     804 45.0% 25-Oct-96 16:28:38 +LibInit.o
  147.     4876    2517 48.3% 25-Oct-96 17:40:00 +samplePNM.datatype
  148.      835     388 53.5% 25-Oct-96 16:28:52 +samplePNM.datatype.info
  149.      245     174 28.9% 25-Oct-96 17:35:00 +SCOPTIONS
  150.      408     156 61.7% 25-Oct-96 16:23:58 +smakefile
  151.      119     104 12.6% 25-Oct-96 16:23:58 +smakefile.wth
  152.     3662    1029 71.9% 13-Sep-96 14:44:58 +StartUp.c
  153.     1060     552 47.9% 25-Oct-96 16:28:38 +StartUp.o
  154.     5085    2014 60.3% 25-Oct-96 17:47:02 +README
  155. -------- ------- ----- --------- --------
  156.    43959   17716 59.6% 25-Oct-96 20:23:12   20 files
  157.